@bugsnag/node

What is @bugsnag/node?

@bugsnag/node is a comprehensive error monitoring and reporting tool for Node.js applications. It helps developers detect, diagnose, and resolve errors in real-time, ensuring a smoother user experience and more stable application performance.

What are @bugsnag/node's main functionalities?

Error Reporting

This feature allows you to report errors to Bugsnag. By initializing Bugsnag with your API key and using the `notify` method, you can send error details to the Bugsnag dashboard for further analysis.

const Bugsnag = require('@bugsnag/node');
Bugsnag.start({ apiKey: 'YOUR_API_KEY' });

try {
  throw new Error('Something went wrong!');
} catch (e) {
  Bugsnag.notify(e);
}

Breadcrumbs

Breadcrumbs are logs of events that lead up to an error, providing context for debugging. This feature allows you to leave breadcrumbs that will be sent along with error reports.

const Bugsnag = require('@bugsnag/node');
Bugsnag.start({ apiKey: 'YOUR_API_KEY' });

Bugsnag.leaveBreadcrumb('User clicked button', { buttonId: 'submit' });

try {
  throw new Error('Something went wrong!');
} catch (e) {
  Bugsnag.notify(e);
}

Custom Metadata

This feature allows you to add custom metadata to your error reports. This can include any additional information that might be useful for debugging, such as user account details or application state.

const Bugsnag = require('@bugsnag/node');
Bugsnag.start({ apiKey: 'YOUR_API_KEY' });

try {
  throw new Error('Something went wrong!');
} catch (e) {
  Bugsnag.notify(e, event => {
    event.addMetadata('account', {
      id: 1234,
      name: 'Acme Co'
    });
  });
}

Session Tracking

Session tracking helps you understand the stability of your application from the perspective of your users. By starting a session, you can track errors that occur during that session and get insights into user experience.

const Bugsnag = require('@bugsnag/node');
Bugsnag.start({ apiKey: 'YOUR_API_KEY' });

Bugsnag.startSession();

try {
  throw new Error('Something went wrong!');
} catch (e) {
  Bugsnag.notify(e);
}

Other packages similar to @bugsnag/node

sentry

Sentry is another popular error tracking and monitoring tool. It provides similar functionalities to Bugsnag, such as error reporting, breadcrumbs, and custom metadata. Sentry also offers performance monitoring and release tracking, which can be beneficial for more comprehensive application monitoring.

rollbar

Rollbar is an error monitoring and alerting tool that helps developers track and fix errors in real-time. It offers features like error grouping, real-time alerts, and detailed error reports. Rollbar also supports a wide range of programming languages and frameworks, making it a versatile choice for error monitoring.

airbrake

Airbrake provides error monitoring and performance management for web applications. It offers features like error aggregation, real-time notifications, and detailed error reports. Airbrake is known for its simplicity and ease of integration, making it a good choice for smaller teams or projects.

README

@bugsnag/node

This package contains the Node.js implementation of the Bugsnag notifier for JavaScript. The normal use case is to install this package via @bugsnag/js, but you can install it directly if you want to.

License

This package is free software released under the MIT License. See LICENSE.txt for details.

Changelog

[7.25.0] - 2024-07-03

Added

• (core) Add new setTraceCorrelation method to events #2159

Changed

• (react-native) Update bugsnag-cocoa from v6.28.1 to v6.29.0
• (react-native) Update bugsnag-android from v5.32.2 to v5.32.3

Fixed

• (react-native) Use synchronous native module calls when New Architecture is enabled #2152
• (react-native) Ensure client is initialised synchronously in bridgeless mode #2165